home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.n / toplevel.n < prev    next >
Text File  |  1995-07-25  |  7KB  |  132 lines
  1.  
  2.  
  3.  
  4.      ttttoooopppplllleeeevvvveeeellll((((nnnn))))                  TTTTkkkk (((( ))))                   ttttoooopppplllleeeevvvveeeellll((((nnnn))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           toplevel - Create and manipulate toplevel widgets
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ttttoooopppplllleeeevvvveeeellll _p_a_t_h_N_a_m_e ?----ssssccccrrrreeeeeeeennnn  _s_c_r_e_e_n_N_a_m_e?  ?----ccccllllaaaassssssss  _c_l_a_s_s_N_a_m_e?
  15.           ?_o_p_t_i_o_n_s?
  16.  
  17.      SSSSTTTTAAAANNNNDDDDAAAARRRRDDDD OOOOPPPPTTTTIIIIOOOONNNNSSSS
  18.           bbbbaaaacccckkkkggggrrrroooouuuunnnndddd      ggggeeeeoooommmmeeeettttrrrryyyy
  19.           bbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh     rrrreeeelllliiiieeeeffff
  20.  
  21.           See the ``options'' manual entry for details on the standard
  22.           options.
  23.  
  24.      WWWWIIIIDDDDGGGGEEEETTTT----SSSSPPPPEEEECCCCIIIIFFFFIIIICCCC OOOOPPPPTTTTIIIIOOOONNNNSSSS
  25.      _________________________________________________________________
  26.  
  27.  
  28.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.           The ttttoooopppplllleeeevvvveeeellll command creates a new toplevel widget (given by
  30.           the   _p_a_t_h_N_a_m_e  argument).   Additional  options,  described
  31.           above, may be specified on the command line or in the option
  32.           database  to  configure  aspects of the toplevel such as its
  33.           background color and relief.  The ttttoooopppplllleeeevvvveeeellll  command  returns
  34.           the path name of the new window.
  35.  
  36.           A toplevel is similar to a frame except that it  is  created
  37.           as a top-level window:  its X parent is the root window of a
  38.           screen rather than the logical parent from  its  path  name.
  39.           The primary purpose of a toplevel is to serve as a container
  40.           for dialog boxes and other collections of widgets.  The only
  41.           features  of  a  toplevel  are  its  background color and an
  42.           optional 3-D border to make the toplevel  appear  raised  or
  43.           sunken.
  44.  
  45.           Two special command-line options  may  be  provided  to  the
  46.           ttttoooopppplllleeeevvvveeeellll   command:   ----ccccllllaaaassssssss  and  ----ssssccccrrrreeeeeeeennnn.   If  ----ccccllllaaaassssssss  is
  47.           specified, then the  new  widget's  class  will  be  set  to
  48.           _c_l_a_s_s_N_a_m_e  instead  of  TTTToooopppplllleeeevvvveeeellll.   Changing  the class of a
  49.           toplevel widget may be useful in  order  to  use  a  special
  50.           class  name in database options referring to this widget and
  51.           its children.  The ----ssssccccrrrreeeeeeeennnn option may be used to  place  the
  52.           window  on  a  different  screen  than  the window's logical
  53.           parent.  Any  valid  screen  name  may  be  used,  even  one
  54.           associated with a different display.
  55.  
  56.           Note:  ----ccccllllaaaassssssss and ----ssssccccrrrreeeeeeeennnn are handled differently than other
  57.           command-line  options.   They may not be specified using the
  58.           option database (these  options  must  have  been  processed
  59.           before  the  new  window  has been created enough to use the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ttttoooopppplllleeeevvvveeeellll((((nnnn))))                  TTTTkkkk (((( ))))                   ttttoooopppplllleeeevvvveeeellll((((nnnn))))
  71.  
  72.  
  73.  
  74.           option database; in particular,  the  new  class  name  will
  75.           affect the lookup of options in the database).  In addition,
  76.           ----ccccllllaaaassssssss and ----ssssccccrrrreeeeeeeennnn may not be queried or changed  using  the
  77.           ccccoooonnnnffffiiiigggg  command  described  below.  However, the wwwwiiiinnnnffffoooo ccccllllaaaassssssss
  78.           command may be used to query the  class  of  a  window,  and
  79.           wwwwiiiinnnnffffoooo ssssccccrrrreeeeeeeennnn may be used to query its screen.
  80.  
  81.  
  82.      WWWWIIIIDDDDGGGGEEEETTTT CCCCOOOOMMMMMMMMAAAANNNNDDDD
  83.           The ttttoooopppplllleeeevvvveeeellll command creates a new Tcl command whose name is
  84.           the  same  as  the path name of the toplevel's window.  This
  85.           command may be used to  invoke  various  operations  on  the
  86.           widget.  It has the following general form:
  87.  
  88.                _p_a_t_h_N_a_m_e _o_p_t_i_o_n ?_a_r_g _a_r_g ...?
  89.           _P_a_t_h_N_a_m_e is the name of the command, which is  the  same  as
  90.           the  toplevel  widget's  path  name.   _O_p_t_i_o_n  and  the _a_r_gs
  91.           determine the exact behavior of the command.  The  following
  92.           commands are possible for toplevel widgets:
  93.  
  94.           _p_a_t_h_N_a_m_e ccccoooonnnnffffiiiigggguuuurrrreeee ?_o_p_t_i_o_n? ?_v_a_l_u_e _o_p_t_i_o_n _v_a_l_u_e ...?
  95.                Query  or  modify  the  configuration  options  of  the
  96.                widget.   If  no  _o_p_t_i_o_n  is  specified, returns a list
  97.                describing all of the available  options  for  _p_a_t_h_N_a_m_e
  98.                (see  TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeIIIInnnnffffoooo for information on the format of
  99.                this list).  If _o_p_t_i_o_n is specified with no _v_a_l_u_e, then
  100.                the  command  returns  a  list describing the one named
  101.                option  (this   list   will   be   identical   to   the
  102.                corresponding  sublist  of  the  value  returned  if no
  103.                _o_p_t_i_o_n is specified).   If  one  or  more  _o_p_t_i_o_n-_v_a_l_u_e
  104.                pairs  are  specified,  then  the  command modifies the
  105.                given widget option(s) to have the given value(s);   in
  106.                this  case the command returns an empty string.  _O_p_t_i_o_n
  107.                may have any of the values  accepted  by  the  ttttoooopppplllleeeevvvveeeellll
  108.                command.
  109.  
  110.  
  111.      BBBBIIIINNNNDDDDIIIINNNNGGGGSSSS
  112.           When a new toplevel is created,  it  has  no  default  event
  113.           bindings: toplevels are not intended to be interactive.
  114.  
  115.  
  116.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  117.           toplevel, widget
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  126.  
  127.  
  128.      Page 2                                          (printed 7/23/95)
  129.  
  130.  
  131.  
  132.